home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: The RISC OS Graphics CD / Acorn User: The RISC OS Graphics CD.iso / utilities / colgrab / _colgrab / docs / _help next >
Encoding:
Text File  |  2000-04-28  |  3.0 KB  |  79 lines
  1. About this program...
  2. ~~~~~~~~~~~~~~~~~~~~~
  3. Name:    ColGrab
  4. Purpose: Grab colours from the desktop
  5. Author:  Richard Goodwin
  6. Version: 0.01 (April 2000)
  7. Status:  Freeware
  8.          This program is © Rich Goodwin 2000;
  9.          it may be freely distributed if:
  10.          * All files remain intact and unaltered
  11.          * No unreasonable charge is made
  12. Web:     http://www.goodwin.uk.com/richard/programs/
  13. ----------------------------------------------------------------------
  14. Disclaimer
  15. ~~~~~~~~~~
  16.  * If it doesn't work, tough.
  17.  * If it trashes anything, well, that's a good lesson in taking backups.
  18. ----------------------------------------------------------------------
  19. Background
  20. ~~~~~~~~~~
  21. While writing my desktop themes manager, someone asked if   it was
  22. possible to grab  colours from the desktop. I didn't know of anything
  23. that did this, but thought it couldn't be too hard... Yeah right.
  24. Anyway, this is a stand-alone version used to test the code, which I'll
  25. no doubt retro-fit into all my other programs at some point.
  26. ----------------------------------------------------------------------
  27. Use
  28. ~~~
  29. Simplicity itself! Just load the program, click on it's iconbar icon,
  30. and click anywhere on the desktop with the left mouse button! You can
  31. carry on using your computer pretty much as normal, but the best match
  32. for the pixel underneath your mouse pointer is displayed in the ColGrab
  33. window.
  34.  
  35. Dragging might be disrupted when ColGrab is working, so to temporarily
  36. disable  ColGrab simply close the ColGrab window!
  37.  
  38. Points to be aware of:
  39.  
  40.  1. Dithering: sometimes you'll get colours that don't appear to
  41.     match what you're  seeing, and when you move across that same
  42.     "colour" ColGrab will sometimes flick between different shades;
  43.     if this happens, chances are the colour you're looking at isn't
  44.     available in the screen mode you're in, and RISC OS is making it
  45.     out of several colours put very close together to fake it.
  46.       
  47.  2. Selection: if, when clicking with the left mouse button, the thing
  48.     you click on changes colour (perhaps a filer icon is inverting, or
  49.     the icon changes to  something else as with radio buttons) then
  50.     you'll probably get the "after" colour (the inverted colour, or the
  51.     colour of the new sprite as opposed to the old).  This can be fixed
  52.     if I add an "always on" option (no need to click on the mouse 
  53.     button), but this will slow the desktop down even more.
  54.  3. Dragging: if you drag an object, or drag a bounding box around
  55.     objects, similar "strange" colouring might happen.
  56. ----------------------------------------------------------------------
  57. History
  58. ~~~~~~~
  59. Release history
  60.  
  61. 0.01 First release 
  62.  
  63. Spent the evening getting it to work in a "print directly to the 
  64. screen" kind of way; this application is basically an attempt to put 
  65. a desktop front-end on to it.
  66. ----------------------------------------------------------------------
  67. Signing off
  68. ~~~~~~~~~~~
  69. If you like this, have problems, suggestions etc. please let me know by
  70. emailing me at richard@goodwin.uk.com.
  71.  
  72. Rich Goodwin
  73. richard@goodwin.uk.com
  74. Friday, 28th of April 2000
  75.  
  76.  
  77.  
  78.  
  79.